Inside Macintosh: QuickTime /

Chapter 2 - Movie Toolbox / Movie Toolbox Reference

Functions for Getting and Playing Movies / Working With Progress and Cover Functions

SetMovieProgressProc

The SetMovieProgressProc function allows you to attach a progress function to each movie. The function will be called whenever a long operation is underway. The Movie Toolbox indicates the progress of the operation to your progress function.

The Movie Toolbox ensures that your progress function is called regularly, but not too often. In addition, the toolbox calls your function only during long operations.

pascal void SetMovieProgressProc (Movie theMovie,
                                  MovieProgressProcPtr p, 
                                  long refCon);

theMovie

Specifies the movie for this operation. Your application obtains this movie identifier from such functions as NewMovie, NewMovieFromFile, and NewMovieFromHandle (described on page 2-80, page 2-76, and page 2-78, respectively).

p

Points to your progress function. To remove a movie's progress function, set this parameter to nil. Set this parameter to -1 for the Movie Toolbox to provide a default progress function. See "Progress Functions" beginning on page 2-333 for the interface your progress function must support.

refCon

Specifies a reference constant. The Movie Toolbox passes this value to your progress function.

DESCRIPTION

The following Movie Toolbox functions use progress functions: ConvertFileToMovieFile (described on page 2-81), CutMovieSelection (described on page 2-231), CopyMovieSelection (described on page 2-232), AddMovieSelection (described on page 2-234), and InsertMovieSegment (described on page 2-241).

ERROR CODES

invalidMovie

-2010

This movie is corrupted or invalid